home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / basic / himath.zip / HIMATH.DOC next >
Text File  |  1991-10-04  |  41KB  |  535 lines
  1.      "HIMATH" Library Routines for QuickBASIC   (c)1991 Kevin T. Jorgensen
  2.      Documentation Page 1
  3.  
  4.      +-----------------+-----------------+-----------------+-----------------+
  5.      |TYPE             |SIMPLE           |3d VECTOR        |COMPLEX          |
  6.      |PRECISION        |DOUBLE           |DOUBLE           |DOUBLE           |
  7.      |RETURNS          |DOUBLE           |VRect            |XRect            |
  8.      +-----------------+-----------------+-----------------+-----------------+
  9.  
  10.      +-----------------------------------------------------------------------+
  11.      |TRIGINOMETRIC ROUTINES                                                 |
  12.      +-----------------+-----------------+-----------------+-----------------+
  13.      |ArcCosine        |ACOS#          2 |                 |                 |
  14.      |ArcSine          |ASIN#          2 |                 |                 |
  15.      |ArcTangent       |ATAN2#         2 |                 |                 |
  16.      |Triangle Solution|TriangleSolve  3 |                 |                 |
  17.      +-----------------+-----------------+-----------------+-----------------+
  18.  
  19.      +-----------------------------------------------------------------------+
  20.      |TRANSLATION ROUTINES                                                   |
  21.      +-----------------+-----------------+-----------------+-----------------+
  22.      |ConvertFromPolar |                 |                 |XCnvP          8 |
  23.      |ConvertFromRect  |                 |                 |XCnvR          8 |
  24.      |Magnitude        |                 |                 |XMag#          8 |
  25.      |Angle            |                 |                 |XAng#          8 |
  26.      |Real             |                 |                 |XReal#         9 |
  27.      |Imaginary        |                 |                 |XImag#         9 |
  28.      |Fmt As Polar Str |                 |                 |XFmtP$         9 |
  29.      |Fmt As Rect Str  |                 |VFmtR$         7 |XFmtR$         9 |
  30.      +-----------------+-----------------+-----------------+-----------------+
  31.  
  32.      +-----------------------------------------------------------------------+
  33.      |ARITHMETIC ROUTINES                                                    |
  34.      +-----------------+-----------------+-----------------+-----------------+
  35.      |ADDITION         |+                |VAdd           7 |XAdd          10 |
  36.      |SUBTRACTION      |-                |VSub           7 |XSub          10 |
  37.      |MULTIPLICATION   |*                |VmltX          7 |XMlt          10 |
  38.      |                 |                 |VMltD#         7 |                 |
  39.      |DIVISION         |/                |                 |XDiv          10 |
  40.      |POWERS & ROOTS   |^                |                 |XPwr          10 |
  41.      |CONJUGATE        |na               |                 |XCnj          11 |
  42.      |INVERSE          |1/X              |                 |XInv          11 |
  43.      +-----------------+-----------------+-----------------+-----------------+
  44.  
  45.      +-----------------------------------------------------------------------+
  46.      |MATRIX OPERATIONS                                                      |
  47.      +-----------------+-----------------+-----------------+-----------------+
  48.      |Add              |MtxAdd         4 |                 |XMtxAdd       12 |
  49.      |Subtract         |MtxSub         4 |                 |XMtxSub       12 |
  50.      |Solve Simul Eq #1|MtxCoeff       4 |                 |XMtxCoeff     13 |
  51.      |Solve Simul Eq #2|MtxCoeffa      5 |                 |XMtxCoeffa    13 |
  52.      |Copy             |MtxCopy        5 |                 |XMtxCopy      13 |
  53.      |Determinant      |MtxDet         5 |                 |XMtxDet       14 |
  54.      |Invert           |MtxInv         5 |                 |XMtxInv       14 |
  55.      |Scaler Product   |MtxMltS        6 |                 |XMtxMltS      14 |
  56.      |Cross Product    |MtxMltX        6 |                 |XMtxMltX      14 |
  57.      +-----------------+-----------------+-----------------+-----------------+
  58.      "HIMATH" Library Routines for QuickBASIC   (c)1991 Kevin T. Jorgensen
  59.      Documentation Page 2
  60.  
  61.      +-----------------------------------------------------------------------+
  62.      | DOUBLE PRECISION INVERSE TRIGINOMETRIC FUNCTIONS                      |
  63.      +-----------------------------------------------------------------------+
  64.      +-----------------------------------------------------------------------+
  65.      |       Function: ArcCosine                                             |
  66.      |        Example: Theta# = ACOS#(x#)                                    |
  67.      |     Parameters: -1 <= x# <=+1                                         |
  68.      |        Returns: Angle in Radians. 0 <= Theta <= Pi                    |
  69.      |           Note: Two Quadrants Only.                                   |
  70.      +-----------------------------------------------------------------------+
  71.      +-----------------------------------------------------------------------+
  72.      |       Function: ArcSine                                               |
  73.      |        Example: Theta# = ASIN#(y#)                                    |
  74.      |     Parameters: -1 <= y# <=+1                                         |
  75.      |        Returns: Angle in Radians. -Pi/2 <= Theta <= Pi/2              |
  76.      |           Note: Two Quadrants Only.                                   |
  77.      +-----------------------------------------------------------------------+
  78.      +-----------------------------------------------------------------------+
  79.      |       Function: ArcTangent                                            |
  80.      |        Example: Theta# = ATAN2#(x#, y#)                               |
  81.      |     Parameters: 1. "x" axis value.                                    |
  82.      |                 2. "y" axis value.                                    |
  83.      |        Returns: Angle in Radians. 0 <= Theta <= 2*Pi                  |
  84.      |           Note: All Four Quadrants. if x=0, function will return a    |
  85.      |                 value of +Pi/2 or -Pi/2 depending upon the value of   |
  86.      |                 y#.                                                   |
  87.      +-----------------------------------------------------------------------+
  88.      "HIMATH" Library Routines for QuickBASIC   (c)1991 Kevin T. Jorgensen
  89.      Documentation Page 3
  90.  
  91.      +-----------------------------------------------------------------------+
  92.      | DOUBLE PRECISION TRIANGLE SOLUTIONS                                   |
  93.      +-----------------------------------------------------------------------+
  94.      +-----------------------------------------------------------------------+
  95.      |     Subroutine: Triangle Solution                                     |
  96.      |        Example: TriangleSolve PType$,p1#,p2#,p3#,A#(),S#(),Sols%      |
  97.      |     Parameters: 1. Problem Type String. Can Be any of the following:  |
  98.      |                                                                       |
  99.      |                      Problem      Parm    Parm     Parm               |
  100.      |                         Type      1 is     2 is     3 is              |
  101.      |                     --------    ------   ------   ------              |
  102.      |                        "SSS"    Side-A   Side-B   Side-C              |
  103.      |                        "SAS"    Side-A  Angle-c   Side-B              |
  104.      |                        "ASA"   Angle-a   Side-C  Angle-b              |
  105.      |                        "AAS"   Angle-a  Angle-b   Side-A              |
  106.      |                        "SSA"    Side-A   Side-B  Angle-a              |
  107.      |                                                                       |
  108.      |                 2. Parameter #1 (see chart)                           |
  109.      |                 3. Parameter #2 (see chart)                           |
  110.      |                 4. Parameter #3 (see chart)                           |
  111.      |                 5. One dimension Array, DIM A#(3), that will receive  |
  112.      |                 the